package com.answeringplayer.mapper;

import com.answeringplayer.domain.User;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 用户Mapper接口
 * 对应XML映射文件: UserMapper.xml
 */
public interface UserMapper {

    /**
     * 根据ID查询用户
     * @param userId 用户ID
     * @return 用户实体
     */
    User selectById(Long userId);

    /**
     * 根据OpenID查询用户
     * @param openid OpenID
     * @return 用户实体
     */
    User selectByOpenid(String openid);

    /**
     * 根据用户名查询用户
     * @param username 用户名
     * @return 用户实体
     */
    User selectByUsername(String username);

    /**
     * 查询排行榜
     * @param limit 查询数量
     * @return 用户列表
     */
    List<User> selectRanking(Integer limit);

    /**
     * 插入用户
     * @param user 用户实体
     * @return 影响行数
     */
    int insert(User user);

    /**
     * 更新用户信息
     * @param user 用户实体
     * @return 影响行数
     */
    int update(User user);

    /**
     * 更新用户统计信息
     * @param userId 用户ID
     * @param consecutiveDays 连续天数
     * @param totalQuestionsAnswered 总答题数
     * @param correctQuestions 正确答题数
     * @param score 分数
     * @return 影响行数
     */
    int updateUserStats(
            @Param("userId") Long userId,
            @Param("consecutiveDays") Integer consecutiveDays,
            @Param("totalQuestionsAnswered") Integer totalQuestionsAnswered,
            @Param("correctQuestions") Integer correctQuestions,
            @Param("score") Integer score
    );

    /**
     * 根据ID删除用户
     * @param userId 用户ID
     * @return 影响行数
     */
    int deleteById(Long userId);
}